home *** CD-ROM | disk | FTP | other *** search
/ Fritz: All Fritz / All Fritz.zip / All Fritz / FILES / DESKHING / RUBICON1.LZH / RUP22C.EXE / MANUAL.2 < prev    next >
Text File  |  1991-06-07  |  29KB  |  627 lines

  1.  
  2.                 ______________________________________
  3.                |                                      |
  4.                |  Section 2: OPERATION AND STRUCTURE  |
  5.                |______________________________________|
  6.  
  7.  
  8. CONTENTS
  9.  
  10. 2.1 General Description
  11. 2.2 Operating Environment
  12. 2.3 Outline of Operating Procedure
  13. 2.4 Run-Time Options
  14. 2.5 Tag Command Syntax
  15. 2.6 Units of Measurement
  16. 2.7 "Include" Files
  17. 2.8 Default Style Sheet: SETUP.TAG
  18. 2.9 Order of Processing Text and Instructions
  19. 2.10 "Push" and "Pop"
  20.  
  21. 2.1 GENERAL DESCRIPTION
  22.  
  23. The Publisher is a computer software product which performs 
  24. functions equivalent to the traditional task of typesetting: that 
  25. is, the formatting and arrangement in type, page by page, of written 
  26. text, in the page layouts, type fonts, etc., chosen by the user.
  27.  
  28. The Publisher consists of two main parts: (1) a typesetting language
  29. consisting of "tags" (instructions) concerning page layout, font
  30. selection, etc., which can be inserted by the user at appropriate
  31. locations in a computer text file; and (2) an executable "batch
  32. processor" program which, upon command, accepts a computer text file
  33. including such tag instructions, interprets and acts on the tags, and
  34. transmits the results directly to a printer (or, optionally, to ther
  35. screen for preview, or to a disk file for later transmission to a
  36. printer). 
  37.  
  38. The Publisher is both user-friendly and sophisticated. The novice, 
  39. or casual user, who has no detailed technical knowledge of typesetting 
  40. techniques, and is familiar with only the most basic of the Publisher's 
  41. instruction tags, can copy or adapt the examples given later in this 
  42. Manual to generate documents of professional appearance in a variety 
  43. of single- and multi-column layouts and formats. In the hands of a 
  44. more knowledgeable user, the Publisher is capable of producing work 
  45. equivalent to the finest conventional typesetting, as found in books 
  46. and magazines of high quality.
  47.  
  48. 2.2 OPERATING ENVIRONMENT
  49.  
  50. HARDWARE
  51.  
  52. The hardware environment required by the Publisher is described in
  53. detail in Section 1.2 of this manual.
  54.  
  55. OPERATING SYSTEM
  56.  
  57. The Publisher supports the MS-DOS operating system, version 2.1 or
  58. newer. 
  59.  
  60. FONTS SUPPORTED
  61.  
  62. The Publisher supports a variety of fonts: the available selection
  63. depends on the type of printer (or other output device) being used. 
  64.  
  65. For Postscript devices, the 35 standard Postscript fonts are supported, 
  66. using Adobe font names.
  67.  
  68. For LaserJet III printers (installed using the LaserJet-3 installation
  69. option) the Publisher supports the Hewlett-Packard Type Director
  70. scalable fonts.
  71.  
  72. For all other printers, the Shareware Edition of the Publisher supports
  73. the Rubicon Trajan (serif) and Renner (sans serif) fonts supplied with
  74. the Publisher. These fonts are supplied in point sizes 6, 8, 10, 12, and
  75. 14, in Regular, Bold and Italic, and in sizes 18, 24 and 30, in Bold
  76. only. For laser printers installed using the LaserJet-2 installation
  77. option, the Publisher also supports the Courier and Line Printer ROM
  78. fonts which are built in to some models.
  79.  
  80. The Commercial/Registered Edition also includes Rubicon's Times, Helv,
  81. Courier, Classic and Nova font families, in point sizes 6, 7, 8, 9, 10,
  82. 11, 12, 14, 16, 18, 20, 24, 30, 36 and 48: all sizes are provided in
  83. Regular, Bold, Italic and Bold Italic. Utilities to install third-party
  84. soft fonts are also included in the Commercial/Registered Edition. 
  85.  
  86.  
  87. TEXT INPUT
  88.  
  89. For efficient use of the Publisher, the available software should
  90. include a good text editor or word processor capable of producing and
  91. editing standard ASCII text files. Most well-known MS-DOS based word
  92. processors will produce standard ASCII files, either in normal operation
  93. or in an available optional mode of operation. 
  94.  
  95. 2.3 OUTLINE OF OPERATING PROCEDURE
  96.  
  97.      2.3.1 PREPARING THE TEXT FILE
  98.  
  99. The Publisher is designed for the batch processing of ASCII-format text
  100. files. Accordingly, the first step in publishing a piece of text (or
  101. "document"), is to produce or obtain the desired text in the form of a
  102. plain ASCII text file. 
  103.  
  104. Text files are, of course, created on computers, using text editing,
  105. word processing, or other software. If a text file is being created for
  106. the purpose of eventual publication using the Publisher, it should be
  107. created in plain ASCII format. If a document to be published is
  108. contained in a text file originally created for some other purpose, it
  109. may or may not be a plain ASCII file, depending on the software
  110. originally used to create it, and on whether it includes any
  111. enhancements, such as bolding, underlining or italics, supported by the
  112. original software. Fortunately, simple procedures are usually
  113. available to convert non-ASCII word processor text files to ASCII
  114. format, and to locate and delete embedded commands, etc., used by the
  115. original software. 
  116.  
  117. Once this has been done, the plain ASCII text file containing the
  118. document is further edited, using a suitable word processor or text
  119. editor, to insert the embedded instructions (known as tags) required to
  120. set up the desired page layout and format, and to implement all desired
  121. font changes and enhancements. 
  122.  
  123. A file ready for publication will typically begin with one or both 
  124. of: (1) A set of tags setting up page layout and format, running headers
  125. and footers, the page numbering scheme, etc.; or (2) An <include> tag
  126. implementing a "style sheet", i.e. a collection of tags setting up page
  127. layout and format, running headers and footers, the page numbering
  128. scheme, etc., which has been previously prepared and stored in a
  129. separate file, so that it can be utilized in any desired document file
  130. without being repeated each time. 
  131.  
  132. After this, the text will appear, with tags inserted at appropriate
  133. locations to implement font changes, enhancements, changes of paragraph
  134. style, special effects, and other such features. 
  135.  
  136. When the document file is believed to be ready for publication, it 
  137. is saved to disk in its final form.  The user then exits from the
  138. word-processing software to the operating system, and logs on to the
  139. directory on which the publisher has been installed (if not already
  140. there).
  141.  
  142. If the Publisher's VGA Preview is available, the usual next step is to
  143. use the Preview to examine the document in published form, on the
  144. screen, before actually printing it, as described in Section 2.3.2.
  145.  
  146. If the Publisher's VGA Preview is not available, you proceed directly to
  147. printing the document, as described in Section 2.3.3.
  148.  
  149.      2.3.2 PREVIEWING THE DOCUMENT
  150.  
  151. The Preview feature provided by the Shareware Edition of version 2.2C of
  152. the Publisher is limited to previewing documents being published using
  153. Rubicon's Trajan and Renner soft fonts in "Portrait" orientation. It
  154. will not accept documents which are in "Landscape" orientation, or are
  155. being published using scalable fonts, that is, using the PostScript or
  156. LaserJet-3 printer options. 
  157.  
  158. A document is Previewed using the Publisher command with the /P switch:
  159.  
  160.                       PUBL [filename] /P [return]
  161.  
  162. EXAMPLE: The document file is named SPECIMEN.TXT, and is located on a
  163. directory named WORK on Drive C. The Publisher is installed in the
  164. directory RUBICON on Drive C [standard setup].  After reaching the DOS
  165. prompt "C>", the command syntax to Preview the document would be: 
  166.  
  167.                     CD\RUBICON [return]
  168.                     PUBL \WORK\SPECIMEN.TXT  /P [return]
  169.  
  170. The Preview displays each standard (8.5x11 inch) document page in 4
  171. overlapping views: Top Left, Top Right, Bottom Left, and Bottom Right.
  172. The initial display is the Top Left view of Page 1. The cursor control
  173. keys (UP, DOWN, LEFT and RIGHT) are used to move from one view to
  174. another on the same page. For example, to move from Top Left to Top
  175. Right, press [CURSOR RIGHT]; to move from Top Right to Bottom Right,
  176. press [CURSOR DOWN], and so on. If your document consists of more than
  177. one page, the [PAGE DOWN] key is used to move from one page to the next.
  178. When you are on the last page, pressing [PAGE DOWN] will conclude the
  179. Preview session and return you to the DOS prompt.
  180.  
  181. To end a Preview session without viewing all pages of your document,
  182. simply press "Q" or "X". This will conclude the Preview session and
  183. retgurn you to the DOS prompt.
  184.  
  185.      NOTE 1: BE PATIENT! The Publisher takes a significant amount of
  186.      time to format and digitize a page, especially when fonts are being
  187.      downloaded. The time required depends on your hardware setup, the
  188.      number of different fonts used in your document, etc.. During much
  189.      of this processing time, the Publisher may not appear to be doing
  190.      anything.  If you are worried that the program may not really be
  191.      running, we suggest that you make use of the run-time switch "/T"
  192.      to invoke the "Tracers" option, as described below in Section 2.4.
  193.  
  194.      NOTE 2: For technical reasons, the Preview display is compressed
  195.      vertically by about 40%: that is, the letters will appear taller,
  196.      and the vertical spaces wider, in the printed document, than they
  197.      appear on the screen. In other respects, the screen display
  198.      closely resembles what you will get from your printer, although
  199.      there may be minor variations in line, column and page breaks if
  200.      your printer is a 180x180 or 300x300 dpi device (e.g. a 24-pin dot
  201.      matrix printer or a laser printer). 
  202.  
  203.      NOTE 3: The Preview supports movement from view to view in any
  204.      direction WITHIN a page, but movement FROM PAGE TO PAGE is
  205.      available in ONE DIRECTION ONLY, namely, to the next page in
  206.      sequence. That is, the Preview does not support a [PAGE UP]
  207.      function. You should therefore make sure that you have finished
  208.      your inspection of each page, before moving on to the next. 
  209.  
  210. If the Preview discloses typographical or typesetting errors or
  211. omissions, you use your word processor to make the necessary changes,
  212. and then Preview the document again. This process is repeated, if
  213. necessary, until the document appears satisfactory.  Remember that you
  214. can terminate the Preview session at any time by pressing the "Q" or "X"
  215. key. If your preview of the first page of a multi-page document reveals
  216. some problem, such as a basic error in the format, your don't have to
  217. take the time to Preview the whole document: you can terminate the
  218. Preview session as soon as you see the problem, and use your word
  219. processor to correct the error, before proceeding further. 
  220.  
  221.      2.3.3 PRINTING THE DOCUMENT
  222.  
  223. A document is printed by using the Publisher command:
  224.  
  225.                       PUBL [filename] [return]
  226.  
  227. EXAMPLE: The document file is named SPECIMEN.TXT, and is located on a
  228. directory named WORK on Drive C. The Publisher is installed in the
  229. directory RUBICON on Drive C [standard setup].  After reaching the DOS
  230. prompt "C>", the command syntax to print the document would be: 
  231.  
  232.                     CD\RUBICON [return]
  233.                     PUBL \WORK\SPECIMEN.TXT [return]
  234.  
  235.      NOTE: BE PATIENT! The Publisher takes a significant amount of time
  236.      to format and digitize a page, especially when fonts are being
  237.      downloaded. The time required depends on your hardware setup, the
  238.      number of different fonts used in your document, etc.. During much
  239.      of this processing time, the Publisher may not appear to be doing
  240.      anything.  If you are worried that the program may not really be
  241.      running, we suggest that you make use of the run-time switch "/T"
  242.      to invoke the "Tracers" option, as described below in Section 2.4.
  243.      
  244. The output from the Publisher ordinarily goes directly to a printer
  245. which produces a hard copy of the document in the layout, format, etc.
  246. specified by the tags in the file. (Optionally, the output can be stored in
  247. a disk file for later transmission to the printer, as described under
  248. "Run-Time Options".) 
  249.  
  250. If the document was carefully Previewed before printing, it is quite
  251. likely that the first printing will conclude the publication process. If
  252. Preview was not available, it is more likely that a careful proofreading
  253. of the hard copy will reveal errors or omissions in the text, or in the
  254. typesetting, or both. You can fix these by using your word processor to
  255. make the necessary changes in the text file, saving it to disk in its
  256. amended form, and printing the amended version. This process may be
  257. repeated as necessary, until a satisfactory result is obtained. The
  258. degree of perfection which is "satisfactory", and the number of "proof"
  259. copies needed to attain it, will of course depend on such factors as the
  260. availability of Preview, the nature and purpose of the document, and its
  261. length and complexity. 
  262.  
  263. 2.4 RUN-TIME OPTIONS
  264.  
  265. In addition to the normal operating mode described above, the program
  266. can be instructed to implement certain options, by means of "switches"
  267. added to the Publisher command line. The following switches are
  268. currently available: 
  269.  
  270. /P   Preview. This option has been described in detail in Seciton 2.3.2.
  271.  
  272. /D   Print to Disk. This option directs the Publisher not to send its
  273. output directly to the printer, but rather to send it to the computer's
  274. disk for storage, under the file name PUB.PRN 
  275.  
  276. For example, entering the command:
  277.  
  278. PUBL \WORK\SPECIMEN.TXT /D [Return]
  279.  
  280. will cause the Publisher to process the file SPECIMEN.TXT from the
  281. directory WORK and store the resulting formatted version on disk under
  282. the file name PUB.PRN. The file thus stored can be printed later by
  283. entering the command: 
  284.  
  285. COPY PUB.PRN PRN /B [Return]
  286.  
  287. That is, "copy the file PUB.PRN to the printer". The /B is the MS-DOS
  288. "binary" option for printing files containing nontextual binary codes.
  289.  
  290. /T Tracers. This option causes the Publisher to generate a running
  291. screen display of its activities, as a document is being printed or
  292. previewed. The command syntax to invoke this option is illustrated by
  293. the example: 
  294.  
  295. PUBL \WORK\SPECIMEN.TXT /T [Return]
  296.  
  297. In general, the Tracers option enables the user to watch what the
  298. program is doing while it is actually running. Its main use is as a
  299. diagnostic (or "trouble-shooting") tool: if the Publisher is having a
  300. problem with some document, Tracers may reveal the nature of the problem
  301. and the exact point in the document where it is happening. 
  302.  
  303. /L Load Font. This option is applicable only to LaserJet-2 printer
  304. installations. It enables the automatic font downloading function. If
  305. selected, the Publisher automatically deletes all soft fonts from the
  306. printer's memory before printing the file, and then downloads each soft
  307. font used in the document, as it is required. The command syntax to
  308. invoke this option is shown by the example:
  309.  
  310. PUBL \WORK\SPECIMEN.TXT /L [Return]
  311.  
  312. This option may also be selected by inserting the instruction tag
  313. <download=1> at the beginning of the document file being typeset. Note
  314. that if either of the run-time switches /L or /X is used, any
  315. <download=> tag in the document file will be disregarded. Note also
  316. that, as supplied, the Publisher's setup file includes the tag
  317. <download=1>, that is, downloading fonts is the default option. The
  318. switch `/L' is required only if the default option has been changed.
  319.  
  320. /X Cancel Load. This option is applicable only to LaserJet-2 printer
  321. installations. It disables the automatic font downloading function; that
  322. is, the Publisher will not delete any soft fonts from the printer's
  323. memory, nor will it download any fonts to the printer. If selected, the
  324. only available fonts will be those which are resident in the printer, or
  325. have previously been downloaded and not deleted. The command syntax to
  326. invoke this option is shown by the example:
  327.  
  328. PUBL \WORK\SPECIMEN.TXT /X [Return]
  329.  
  330. The automatic deletion of all soft fonts from the printer's memory
  331. before printing a file, and subsequent downloading of each soft font
  332. used in the document, is a lengthy process, particularly if numerous
  333. fonts are used. If several successive drafts of the same document, or a
  334. series of documents each requiring the same group of fonts, are being
  335. formatted and printed, this results in the repeated deleting and then
  336. downloading of the same group of fonts, which is obviously inefficient
  337. and a waste of time. To avoid this, the /X option may be invoked after
  338. the first document in the series has been processed, that is, for the
  339. second and all subsequent drafts or documents in the series. Of course,
  340. this option will work successfully only if the group of soft fonts being
  341. used is small enough (or the printer's memory large enough) that the
  342. printer can store the whole group in memory at the same time. 
  343.  
  344. This option may also be selected by inserting the instruction tag
  345. <download=0> at the beginning of the document file being typeset. Note
  346. that if either of the run-time switches /L or /X is used, any
  347. <download=> tag in the document file will be disregarded. 
  348.  
  349. /num  Multiple copies. This option is available for LaserJet-2,
  350. LaserJet-3 and PostScript printer installations only. Selecting this
  351. option causes the printer to print "num" copies of each page of the
  352. document, where "num" is an integer (that is, a whole number) in the
  353. range of 1 to 99. For example, entering the command 
  354.  
  355. PUBL \WORK\SPECIMEN.TXT /7 [Return]
  356.  
  357. will cause the printer to print 7 copies of each page of the file
  358. SPECIMEN.TXT. After a file is printed the formatter automatically resets
  359. itself, and the attached printer, to the default state of single copy
  360. printing. 
  361.  
  362. 2.5 TAG COMMAND SYNTAX
  363.  
  364. As previously explained, a major component of the Publisher is a
  365. typsetting language, in the form of instruction tags which can be
  366. inserted into an ordinary text file using any suitable text editor. When
  367. such a file is submitted to the Publisher's batch processor program, it
  368. prints the file using the fonts, format and page layout specified by
  369. these tags. 
  370.  
  371. The tags are identified, i.e. delimited from the rest of the text, by
  372. being enclosed between a left-chevron "<" and a right-chevron ">", as
  373. follows: <Tag>. The first element of any tag is a "keyword", which may
  374. be an abbreviation of one or more letters. 
  375.  
  376. Some tags consist of nothing but the keyword. EXAMPLE: <RC> Rag 
  377. Center (Center each line of type on the page, so that both left and 
  378. right margins are "ragged").
  379.  
  380. Some tags require other elements, such as parameter names and values,
  381. and designations of units, to give them meaning.  EXAMPLE: the tag
  382. <margin> means nothing by itself, but the tag 
  383. <margin top=20mm left=15mm bottom=230mm right=190mm> 
  384. defines the sizes in millimeters of the top, left, bottom and right
  385. margins which form the limits of the page interior. 
  386.  
  387. There are three basic kinds of tags: isolated keywords, keywords with 
  388. a single parameter, and keywords with one or more sub-parameters. 
  389. Examples of each are, respectively:
  390.  
  391. <XR> Cancel Rag
  392.  
  393. <Trajan10B> Trajan 10 point bold
  394.  
  395. <underline thick=2pt descent=1pt> Underline thickness and descent 
  396.  
  397. SYNTAX FLEXIBILITY
  398.  
  399. Tag keywords may be entered in upper or lower case, i.e. the tags 
  400. <XR> and <xr> represent the same instruction. Subparameters are optional, 
  401. and may be specified in any order. This margin tag is equivalent to 
  402. the one just above:
  403. <margin bottom=230mm right=190mm top=20mm left=15mm>
  404.  
  405. This margin tag is permissible:
  406. <margin bottom=230mm right=190mm>
  407.  
  408. PARAMETER TYPES
  409.  
  410. Parameter input types may be single characters, character strings 
  411. (like the name of a file), or integers (like the number 10). "Rational 
  412. numbers", that is "floating point decimal numbers" like 2.664 are 
  413. also used; these will be referred to simply as "numbers", as opposed 
  414. to integers.
  415.  
  416. The various tags included in the Publisher's typsetting language, and
  417. their functions, are described in the ensuing sections of this manual. 
  418.  
  419. PUNCTUATION OF INSTRUCTIONS
  420.  
  421. Lines in a document or instruction file which consist entirely of 
  422. instruction tags, must normally be punctuated by means of Quad tags 
  423. at the end of each such line, to prevent unwanted blank lines and 
  424. spaces from appearing in the published document, or other undesirable
  425. results. The tag most commonly used for this purpose is: 
  426.  
  427. <QZ> Quad left, zero advance.
  428.  
  429. This is particularly important in lines of instruction tags located in
  430. the initialization sequence, or in files INCLUDED in the "initialization
  431. sequence" (the basic setup and format instructions which must be given
  432. to the Publisher at the start of processing) , since the initialization
  433. sequence MUST NOT CONTAIN ANY PRINTABLE CHARACTERS. (To the computer, a
  434. blank space is a printable character: ASCII character number 32.) 
  435.  
  436. The following Publisher tags are classed as DIRECTIVES and do not
  437. require Quad tags for punctuation. 
  438.  
  439. <include>     include file
  440.  
  441. <header>      start header definition
  442.  
  443. <footer>      start footer definition
  444.  
  445. <end>         end header or footer definition
  446.  
  447. <NP>          New Page (insert hard page break)
  448.  
  449. <NC>          New Coluomn (insert hard column break)
  450.  
  451. Unlike other tags, A DIRECTIVE MUST APPEAR BY ITSELF ON A SEPARATE LINE.
  452. That is, there should be no other material whatsoever on the same input
  453. line as the directive tag, either before or after it. 
  454.  
  455. 2.6 UNITS OF MEASUREMENT 
  456.  
  457. Some parameters represent a LINEAR MEASURE or distance, such as margin
  458. width or column width. When giving a value for such a parameter, you
  459. MUST SPECIFY THE UNIT OF MEASUREMENT you are using. 
  460.  
  461. To specify a measurement unit, you insert the Publisher's abbreviation
  462. for the unit immediately after the paramenter value. EXAMPLES: the tags
  463.  
  464.  <margin top=0.5in>
  465.  <margin top=36pt>
  466.  <margin top=1.27cm>
  467.  
  468. all specify a top margin of one-half inch. You can use any unit
  469. recognized by the Publisher, but naturally you must tell the Publisher
  470. which one you are using.
  471.  
  472. The units recognized by the Publisher, and their abbreviations, are:
  473.  
  474. ABBREVIATION    NAME OF UNIT        SIZE OF UNIT
  475.  
  476. in              inches              1in = 1 inch
  477.  
  478. cm              centimeters         2.5400cm = 1 inch
  479.  
  480. mm              millimeters         25.4001mm = 1 inch
  481.  
  482. pc              picas               6pc = 1 inch
  483.  
  484. pt              points              72pt = 1 inch
  485.  
  486. ln              lines               the interline leading (line spacing)
  487.  
  488. em              em-widths           the point size
  489.  
  490. cl              column-widths       the column-width
  491.  
  492. ex              ex-height           height of `x' in current font
  493.  
  494.  
  495. The first 5 units listed are "absolute" units; that is, they always have
  496. the same fixed value. The remaining 4 units are "relative" units; their
  497. values depend on the values of other parameters, such as the point size
  498. (size of lettering) or the column width in the document in which they
  499. are used.
  500.  
  501. 2.7 "INCLUDE" FILES
  502.  
  503. One of the most important convenience features of the Publisher is its
  504. ability to read and act upon sets of instruction tags which have been
  505. previously stored in disk files separate from the text file being
  506. processed. This is accomplished by means of the tag: 
  507.  
  508. <INCLUDE filename>  
  509.  
  510. If a set of instructions is stored in a file called (say) COMMAND.SET,
  511. the set can be invoked at any point in any text file by inserting the
  512. tag <include command.set> in the text file. 
  513.  
  514. This means that any set of tags which is going to be used frequently 
  515. only needs to be entered once, and stored in a separate file with 
  516. a suitable name. It can then be invoked whenever needed by means of 
  517. a single <include> tag.
  518.  
  519. The include tag is a DIRECTIVE, and must appear by itself on a separate
  520. line. That is, there should be no material on the same line as the
  521. <include> tag, either before or after. 
  522.  
  523. A form of instruction file which is particularly useful is a STYLE
  524. SHEET, which contains complete instructions for the format and layout of
  525. some particular type of document. The user can easily maintain style
  526. sheets on disk for the most frequently used document layouts, and
  527. utilize them as required by means of the <include> directive tag. 
  528.  
  529. 2.8 DEFAULT STYLE SHEET: SETUP.TAG
  530.  
  531. When the Publisher starts to process a document file, it automatically
  532. "includes" the file SETUP.TAG. This file normally contains a "style
  533. sheet" (a set of document format and page layout instruction tags)
  534. intended to govern the operation of the Publisher in the absence of
  535. instructions to the contrary. It also usually contains special publisher
  536. "system" tags, regarding the model of printer being used, the location
  537. on disk of the available soft fonts, etc.. The file SETUP.TAG is
  538. generated automatically during the installation of the Publisher, based
  539. on the printer option, etc., which you choose during installation. 
  540.  
  541. The style sheet contained in the file SETUP.TAG is known as the "default
  542. style sheet", since it provides the format and page layout which the
  543. Publisher adopts when you have not specified anything else. To use a
  544. different style, you can simply place over-riding instruction tags at
  545. the beginning of your document file; alternatively, you can place such
  546. tags in a separate instruction file which can be incorporated into your
  547. document file by an <include...> command. 
  548.  
  549.          [Note: SETUP.TAG is a plain ASCII text file, and you can amend
  550.          it by means of your word processor, to change the "default"
  551.          style. However, you should wait until you have become familiar
  552.          with the Publisher, and know exactly what you are doing, before
  553.          attempting any amendment to SETUP.TAG, and you should always
  554.          keep a copy of the original SETUP.TAG as a backup.] 
  555.  
  556.  
  557. 2.9 ORDER OF PROCESSING TEXT AND INSTRUCTIONS 
  558.  
  559. The Publisher processes the input text and instructions in the following
  560. order: 
  561.  
  562. 1.   The file SETUP.TAG (which must not contain any printable matter,
  563. including blank lines or blank spaces). 
  564.  
  565. 2.  The initial part of the document file, preceding the first printable
  566. character or space. (When an <include> instruction is encountered, the
  567. effect is the same as if the entire contents of the "included" file were
  568. inserted in the document file at the point where the <include>
  569. instruction is located.) 
  570.  
  571. 3.   Runtime switches (Described in Section 2.4.) 
  572.  
  573. 4.   The text and embedded instruction tags in the document file, in the
  574. order in which they appear, starting with the first printable character
  575. or space. 
  576.  
  577. Note: Certain commands may only be placed in the "initialization
  578. sequence", which consists of the SETUP.TAG file, the initial portion of
  579. the document file (preceding the first printable character), and files
  580. "included" in the initial portion of the document file. EXAMPLES: 
  581.  
  582. <margin top= bottom= left= right= >   Location of page margins.
  583.  
  584. <landscape=>    On or Off
  585.  
  586. Common sense can be used here: Any information the printer needs to
  587. start printing must be given to it before it actually prints anything. 
  588.  
  589. The operation of the Publisher as it proceeds through the document 
  590. file is continually governed by the MOST RECENT instructions it has
  591. received. It will therefore operate in accordance with the instructions
  592. in SETUP.TAG unless and until these instructions are replaced by new
  593. instructions contained in the document file, or in a file "included"
  594. in the document file, or conveyed by means of run-time switches. When
  595. new instructions are encountered, the Publisher will start operating in
  596. accordance with them at the point in the document file where they are
  597. encountered, and will continue to so operate until they are replaced by
  598. still further instructions. 
  599.  
  600. If a document file contains no format or layout instructions, the
  601. Publisher will process the whole document in the format and layout
  602. prescribed by SETUP.TAG, subject to any run-time switches. 
  603.  
  604. 2.10  "PUSH" AND "POP"
  605.  
  606. The tags:
  607.  
  608. <push> and
  609.  
  610. <pop>
  611.  
  612. can save substantial amounts of time and effort, and reduce the risk 
  613. of inadvertent errors and omissions, when publisher parameters are 
  614. being changed temporarily: for example, when a heading is being printed 
  615. in a different font, or when a passage of text is being printed with 
  616. a different paragraph style from the rest of the document.
  617.  
  618. The tag <push> saves a record of the current state of many publisher
  619. variables, including font and indentation, and the tag <pop> restores
  620. the state of the publisher which was most recently "pushed".
  621. Accordingly, if a <push> tag is inserted BEFORE the instruction tags
  622. which are used to implement the temporary changes, it will be possible
  623. to cancel the temporary changes (after they have served their purpose)
  624. by means of a single <pop> tag, instead of using a series of instruction
  625. tags to change the publisher variables back to their previous values one
  626. by one. 
  627.